lol HJtnMsaltioiDi de la mmemenre FLASH 

1.1.1 Principe de fonctionnement de la memoire FLASH 

La m&noire FLASH est une zone de m&noire capable de conserver des donn£es en l'absence d' alimentation. Elle sert k 
m^moriser de maniere durable des informations importantes du systeme et des applications tournant dans le d£codeur. 

Si la memoire FLASH est accessible librement en lecture, P^criture, plus complexe, et soumise k certaines contraintes : 
o II n'est pas possible de faire passer un bit de la valeur z€vo a la valeur un sans effacer (mettre k un) une page enttere. 

La taille d'une page varie selon les memoires FLASH. Elles sont generalement de 16 ou 64 Kilo-octets, 
o La mise k zero d'une page prend un temps non n^gligeable de l'ordre de la seconde. 

o Meme une Venture ne faisant passer que des bits de la valeur un k zero ne peut se faire par un acces direct k la 

memoire FLASH. II faut passer par les Devices qui positionnent la memoire en mode d'£criture avant de lui envoyer 
(de maniere s^quentielle ?) les nouvelles valeurs des octets. 

Cette memoire servant a m£moriser des informations parfois indispensables au bon fonctionnement de 1'IRD, il est 
n^cessaire d'assurer sa coherence. En particulier il faut s'assurer que Ton peut toujours revenir k un 6tat stable k la mise 
sous tension meme en cas de coupure brutale et impromptue de 1' alimentation. 

1 . 1 .2 Utilisation de la memoire FLASH dans le RUN 

Le RUN 6crit toujours dans la memoire FLASH page par page en utilisant une page tampon. A chaque fois que Ton veut 
6crire un fichier dans la memoire FLASH on cherche une page avec assez de place libre pour m^moriser le contenu du 
fichier. Cette page peut §tre celle contenant la valeur pre"ce*dente du fichier qui sera remplace'e par la nouvelle valeur ou 
une nouvelle page si le fichier est nouveau. La page tampon est effaced. Les donne*es valides de la page choisie sont 
recopie*es dans la page tampon. La page choisie devient la nouvelle page tampon. 

Les informations concernant la coherence des donne*es (numero de la page tampon actuelle, CRC des pages) sont 
memorises dans une EEPROM. 

Cette utilisation comporte plusieurs inconv£nients : 

o L'efFacement de la page tampon se fait juste avant l'e'criture (a verifier) d'ou perte de temps. II serait preferable 

d'effectuer reffacement de la nouvelle page tampon juste apres Te'criture dans 1'ancienne. 
o II est n^cessaire d'avoir en me*moire RAM un buffer de meme taille que la page k 6crire. 
o Necessity d'e*crire toute la page d'un coup, 
o La presence d'une EEPROM est indispensable. 

1.1.3 Utilisation de la memoire FLASH dans la MVM 

On utilise la possibility offerte dans la nouvelle API, d'^crire un certain nombre d'octets a un endroit encore vierge 
d'une page de memoire FLASH. Tant qu'il reste possible d'6crire dans une page qui n'est pas pleine on rajoute des 
blocs k la fin cette page. Les blocs precedents sont invalided en positionnant k zero certain bits de l'en-tete des blocs. 

La MVM garde une page tampon qui est utilisSe, lorsque toutes les autres pages sont satur£es, pour recopier une page 
contenant beaucoup de donnees invalides en supprimant ces donnees invalides. La nouvelle page tampon est toujours 
effacSe immediatement apres une recopie. 

Les informations de coherence sont m6moris£es dans les pages elles-memes. 
Les avantages de cette utilisation sont : 

° La plupart du temps il est juste necessaire d'ecrire le bloc que Ton veut modifier et non toute la page. 

o La plupart du temps il n'est pas necessaire d'attendre l'effacement la page tampon avant d'ecrire (sauf si Ton doit 

ecrire plusieurs pages successivement). 
° M§rne pendant la recopie d'une page vers la page tampon, il est possible de copier les donnees bloc par bloc. II est 

par consequent uniquement necessaire de r^server en memoire RAM la taille du plus grand bloc. 
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1.2 Le format des fichiers dams la m empire FLASH 

Chaque page de la memoire FLASH se compose d'un en-tete et de plusieurs blocs consecutifs de donnees Un fichier 
sera compose de un ou plusieurs blocs repartis dans une ou plusieurs pages. Un repertoire se compose d'un seul bloc 
Chaque fich.er ou repertoire possede un identificateur unique. Chaque fichier ou repertoire fait reference par son 
identificateur, au repertoire auquel il appartient. ' p 

1 .2. 1 Format et co herence des pages dans la memoire FLASH 

Les informations concernant la coherence des donnees en memoire FLASH seront memorisees dans la memoire FLASH 
elle-meme. Pour les pages de la memoire FLASH l'en-tete decrit ses etats possibles au cours de sa « vie » • 
o Page vierge (Empty). 

o Page en cours de creation (Write) et numero de la page qui est en cours de recopie ici. 
o Recopie terminee (New) et numero de la page qui vient d'etre recopiee ici. 
o Page valide (Valid) 
o Page invalide (Invalid) 

Ces etats sont codes par des valeurs numeriques qui permettent toujours de passer d'un etat a un etat ulterieur Le 
premier etat (Empty) est obtenu en effacant la page. L'en-tete de la page contient aussi un « magic number » comme 
verification supplementaire de la validite de la page. Des octets inutilisfe sont inserts pour que chaque crZp 
commence a une adresse multiple de sa taille et que chaque bloc commence sur un multiple de la plus grande taille de 
champ possible : celle du mot long (8 octets). S^uiuc wine ae 

Les etate Write, New et Invalid sont des etats temporaires utilises pendant la recopie d'une page vers la page tampon qui 
est la phase la plus cntique. Ces etats permettent de restaurer la coherence a la raise sous tension merne en cas d'curet 
pendant la copie. 

pagtTl l S '?telVa/!/ a8eS m6m0he CaraCt6ris6 Par la prfaence d ' au moins me P a & dans i'etat Empty et d'autres 

Une recopie d'une page vers la page tampon a partir d'un etat stable passe par les etapes suivantes • 

1 . Passage de la page tampon de l'etat Empty a l'etat Write. Le numero de la page source est memorise dans l'en-tete 
de la page tampon. 

2. Recopie des donnees utiles de la page source vers la page tampon. Cette recopie peut se faire bloc par bloc 
Cependant le passage a l'etat New ne se fera que lorsque tous les blocs valides de la page source auront ete copies 
ou remplac6s par de nouvelles versions. p 

3. Passage de la page tampon de l'etat Write a l'etat New. 

4. Passage de la page source de l'etat Valid a l'etat Invalid. 

5. Passage de la page tampon de l'etat New a l'etat Valid. II ne s'agit plus d'une page tampon 

6. Effacement de la page source. Passage a l'etat Empty. 

S'il arrived la mise sous tension qu'une page et une seule ne soit pas dans l'etat Empty ou Valid, il y a eu arret pendant 
la copie. On peut restaurer un etat stable en fonction de l'etat de cette page- ipenaant 

'° ^ a P age <f dan f I'f" Write ■ on ] ' eff ace. Elle passe a l'etat Empty. Les donn6es en cours de copie sont perdues 

Les donnees precetientes sont toujours presentes et valides. 
o La page est dans l'etat New : on invalide la page qui vient d'etre copiee (etat Valid vers etat Invalid), puis on valide 

Empty) COUrante ^ VCrS ^ en&1 ° D effaCC ^ PagC qUi Vknt d ' 6tre COpi6e (<5tat Imalid vers etat 

° La page est dans l'etat Invalid : on l'efface. Elle passe a l'etat Empty. 

Llir,!!\ Pa ? 5 T i Ver que plus d,une P a 8 e soit d ans un etat different de l'etat Empty ou Valid. Si cela se produisait 
tout? fa TIm^7?LA^ me * ^ ^V*™ ** * et prendrB dCS m6SUreS radica,es ( effa ^"t de 
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La Figure 1 montre le format general d'une page de*la m^motre FLASH et donne les valeurs nume>iques cbrrespondant 
aux differents £tats de la page. 



1 byte 1 byte 



4 bytes 



Etat 



Pad 



N° de la page 



Page 



< III 



OxFF : vierge 
OxFE : copie en cours 
OxFC : copie terminer 
0xF8 : valide 
OxFO : invalide 




Entete 



loc 1 



-Bloc 2 



OxDEBADEBA : si la page n'est pas ||| 




li iii illltt ti t ti tiii |t*iit i t tttii ti 



/^Blocn 



Figure 1 : Format des pages de la memo ire FLASH 

1 .2.2 Format et coherence des fichiers dans la memoire FLASH 

Chaque fichier est compost de un ou plusieurs blocs. Un bloc est une zone de la memoire FLASH contenue dans une 
page. Chaque bloc comprend un en-tete permettant de geYer sa coherence et de recomposer le fichier auquel il 
appartient. 

Comme une page un bloc peut avoir plusieurs etots au cours de sa « vie » : 

o Bloc libre (Free). Seul le dernier bloc d'une page peut £tre dans cet 6tat. II repr^sente toute la partie de la page 

encore utilisable pour des Ventures de nouveaux blocs, 
o Bloc en cours de creation (Create). L'en-tete du bloc (y compris sa taille) est en cours d'Scriture. La taille du bloc 

contenue dans 1* en-tete peut ne pas §tre encore valide. 
o Bloc en cours d'dcriture (Write). L*en-t£te du bloc done sa taille est valide. Les donn^es peuvent ne pas 8tre encore 

valides. 

° Bloc nouvellement valide* (New). Le bloc est pret a etre utilise si tous les autres blocs a modifier pour ce meme 

fichier sont aussi nouvellement valide\ 
o Bloc valide (Valid). L'ancienne version du bloc, si elle existait, a &e* invalid6e. Le bloc sera utilise" a la prochaine 

utilisation du fichier. 

° Bloc invalide (Invalid). Une nouvelle version de ce bloc a 6t6 cr€€e ou le fichier a 6t& efface\ 
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L'en-tete de chaque bloc contient un octet pour memoriser Petat du bloc. Cet octet sert aussi a memoriser les 
informations suivantes qui concernent plutot Petat du fichier auquel appartient le bloc : 
o Ce bloc est le bloc d'indice le plus eieve ecrit pour ce fichier (bit Ending). 

o Ce bloc appartient a un fichier en cours d'ecriture (bit Open). Seul un bloc Ending peut aussi etre Open, 
o Ce bloc appartient a un repertoire (bit Directory). 

L'en-tete d'un bloc contient aussi Pidentificateur du fichier auquel il appartient et 1'index du bloc parmi les blocs 
composant le fichier. Combines avec I'etat de chaque bloc, ces informations permettent de restaurer la coherence de 
chaque fichier meme en cas d' arret durant la copie. 

Enfin l'en-tete contient la taille des donnees du bloc ce qui permet de trouver le bloc suivant. 

Chaque entree de Parbre est composee d'au moins un bloc. Le premier bloc ne contient pas les donnees de P entree mais 
des informations sur P entree. Ces informations sont : 

o L'identificateur du repertoire auquel appartient cette entree. Cette information permet de recreer l'arborescence des 
fichiers. 

o Un octet decrivant les attributs de l'entree (fichier ou repertoire, ...). 

o Un octet decrivant les modes d'acces autoris^s sur ce fichier pour le proprietaire, pour le groupe et pour les autres. 
o Deux octets identifiant le proprietaire du fichier 
o Deux octets identifiant le groupe du fichier 

o Faut-il memoriser la date de creation et la date de modification du fichier ? 
o Le nom du fichier termini par un code ASCII de zero. 

Un repertoire peut etre vu corame un fichier ne contenant que ce premier bloc. 

La Figure 2 ci-dessous le contenu du premier bloc d'un fichier ou d'un repertoire avec la description de Pen-t6te. 



16 bytes 4 bytes 1 byte 1 byte 2 bytes 2 bytes 2 bytes 
A A A A A A A 




f \ 


r > 


f ^ 


r > 


( ^ 




Header 


Father ID 


Attributes 


Access mode 


Owner 


Group 


Version 



ID 


Size 


Rank 


Flags 


Reserved 


1 Y * 


[ v ^ 


^ Y 1 


[ Y— ^ 












\ — Y 


4 bytes 


4 bytes 


1 byte 


1 byte 


) 2 bytes 




Ox.. 


.IF 


Empty 


OxE 


. : Open 


Ox.. 


.IE 


: Create 


OxC 


. : Ending 


Ox.. 


.1C 


: Write 


OxA 


. : Directory 


Ox.. 


.18: 


New 






Ox.. 


.10: 


Valid 






Ox.. 


.00 : 


Invalid 







Dir 


End 


Open 


Bloc Status 






J 


\. 




J 




3 bits 






V 
5 bits 





Figure 2 : En-tete et donnees du premier bloc d'un fichier ou d'un repertoire 
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1.2.2.1 Ecriture d'un repertoire ou d'un fichier compose d'un seul bloc 
C'est le cas le plus facile. On enchaine les Stapes suivantes : 

1 . Trouver, a la fin d'une page, un bloc libre capable de contenir le bloc a ecrire. II est dans Petet Free, 

2. Creation de Pen-tete du nouveau bloc. Passage du bloc a P6tat Create, les bits Ending et Open restent a 1, puis 
ecriture de Pen-t§te : identificateur du fichier, indice du bloc dans le fichier (bloc numero 1), taille du bloc. 

3. Passer le bloc a P6tat Write. Ecriture des donnees du bloc. 

4. Passer le bloc a Petat New. Cet 6tat permet d'attendre que tous les autres blocs du fichier soit ecrits et les anciennes 
versions des blocs invalides. Dans le cas d'un fichier monobloc c'est un eiat tres temporaire. 

5. Passer le bit Open a ze>o. Cette etape correspond a la fermeture du fichier. A partir de maintenant les nouvelles 
donnees seront validees meme en cas d' arret et de redemarrage du systeme. 

6. Passer Pancienne version du bloc, si elle existe, a Petat Invalid. 

7. Passer la nouvelle version du bloc a Petat Valid. 



1.2.2.2 Ecriture d'un fichier compose de plusieurs blocs 

On execute plusieurs fois une partie des etapes utilisees pour un fichier contenant un seul bloc. La methode est la 
suivante : 

o Les Stapes 1 a 4 sont efFectuees par indice croissant des blocs modifies du fichier. Si un bloc est identique a la 
version existante il n'est pas necessaire de creer une nouvelle version. 

A chaque nouveau bloc, passer les bits Ending et Open du bloc New prec^demment terminal a zero si le nouveau 
bloc a un indice superieur. 

o Si la fermeture du fichier demande la troncature, le bit Open du bloc New et Ending est pass£ a zero, validant tous 
les nouveaux blocs. 

o Si la fermeture du fichier ne demande pas la troncature, le bit Ending du bloc New d'indice le plus elevS est passe a 
zero. 

o Le bit Open du bloc New d'indice le plus 6\ev6 est pass6 a zero, validant tous les nouveaux blocs. 

o L'^tape 6 est effectuee par indice croissant sur les anciennes versions de tous les blocs qui ont 6t6 modifies. 

o L'dtape 7 est effectuee par indice croissant sur les nouvelles versions de tous les blocs qui ont 6t& modifies. 

1.2.2.3 Restauration de Vintegrite de la memoire FLASH 

Examinons comment, en utilisant les etapes d'ecriture decrites ci-dessus, il est possible de restaurer Fintegrit£ de la 
memoire FLASH meme en cas d' arret durant n'importe laquelle de ces etapes. 

Au dernarrage de PIRD, la memoire FLASH est parcourue page par page. Suivant Petat de chaque bloc on effectue 
Pune des operations suivantes : 

o Le bloc est dans Petat Free. C'est tres bien, on le laisse tranquille et on peut passer a la page suivante. 

o Le bloc est dans Petat Create, L'en-tete du bloc n'est pas dans un etat coherent. En particulier la taille des donnees 

contenue dans Pen-tete peut etre invalide. On laisse le bloc dans cet etat. Le bloc suivant commence juste derriere 

Pen-tete de celui-ci. 

t o Le bloc est dans Petat Write. La taille du bloc contenue dans Pen-tete est valide. Les donnees sont en cours 

d'ecriture done partiellement invalides. Le bloc passe a Petat Invalid. Le bloc suivant commence apres les donnees 

de celui-ci : il faut avancer de la taille de Pen-tete plus la taille des donnees. 
o Le bloc est dans P6tat New. Le bloc est memorise dans la liste des blocs du fichier dont P identificateur est celui 

contenu dans Pen-tete. Ce bloc sera valid£ ou non lors d'une deuxieme passe de verification qui sera effectuee sur 

chaque fichier. Le bloc suivant commence apres les donnees de celui-ci. 
o Le bloc est dans Petet Valid. Meme traitement que pour un bloc dans Petat New. 

o Le bloc est dans Petat Invalid. On le laisse tranquille. Le bloc suivant commence apres les donnees de celui-ci. 

Cette premiere passe a permit d'invalider les blocs a Petat Write et surtout de memoriser tous les blocs Valid ou New de 
chaque fichier. II s'agit maintenant de decider quels blocs utiliser pour chaque fichier. On se trouve confronte a plusieurs 
configurations differentes que Pon va verifier Pune apres Pautre : 

o Le fichier contient un bloc a Petat New et Open. Une creation de fichier etait en cours mais elle n'est pas terminee. 

II faut faire passer tous les blocs New du fichier a Petat Invalid. 
° Le fichier n'a pas de bloc Ending et contient au moins un bloc Valid. Theoriquement impossible : la memoire 

FLASH est corrompue. II faut faire passer tous les blocs du fichier a l'etat Invalid et detruire le fichier. 
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o II existe un bloc Ending Valid et au moins un bloc Valid avec un indice superieur ou il existe plus d'un bloc Valid 

de meme indice. Theoriquement impossible : la memoire FLASH est corrompue. II faut faire passer tous les blocs 

du fichier a Petat Invalid et detruire le fichier. 
o II existe un bloc Ending New et au moins un bloc New avec un indice superieur ou il existe plus d'un bloc New de 

meme indice. Theoriquement impossible : la memoire FLASH est corrompue. II faut faire passer tous les blocs a 

Petat New du fichier a Petat Invalid puis continuer les verifications suivantes. 
o Les indices de blocs du fichier ne sont pas contigus : ils ne commencent pas a zero ou il existe des indices 

intermediaires manquant. II faut faire passer tous les blocs New du fichier a Petat Invalid. Si les blocs Valid rssXant 

ne sont pas non plus contigus, la memoire FLASH est corrompue : il faut faire passer tous les blocs du fichier a 

Petat Invalid (done detruire le fichier). 
o II existe des blocs New mais pas de bloc Open. Une ecriture vient de se terminer. Une nouvelle version de certains 

blocs du fichier a ete ecrite avec succes. Les anciennes versions des blocs sont en cours d' invalidation. S'il existe un 

bloc New Ending et un bloc Valid Ending, la fermeture avait demande la troncature : le bit Ending du bloc Valid 

doit etre passe a zero. Ensuite il faut poursuivre P invalidation par indice croissant des blocs Valid ayant un bloc 

New de meme indice. Enfin, ii faut valider par indice croissant tous les blocs New. 
o Tous les blocs du fichier sont Valid. Un seul bloc terminal existe. Son indice est n. Aucun bloc n'a un indice 

superieur a n. Tous les indices entre 1 et n sont present une et une seule fois. C'est le cas ideal dans lequel tous les 

fichiers encore existant doivent se trouver apres la phase de verification en cours. 

1.2.3 Coherence de Parbre des fichiers dans la memoire FLASH 

II reste a verifier que tous les fichiers et repertoires dans la memoire FLASH sont bien relies a la racine. Pour cela il faut 
verifier que chaque repertoire est relic" a la racine (identificateur zero) en remontant Parbre de maniere recursive. Si a un 
moment de la remontee le pere d'un repertoire est introuvable ou n'est pas un repertoire (ce dernier cas est 
theoriquement impossible), le repertoire doit £tre detruit (son bloc invalid^). 

Apres le parcours sur tous les repertoires, il faut verifier que chaque fichier a bien pour pere un repertoire existant. Si ce 
n'est pas le cas le fichier doit etre detruit (tous ses blocs invalides). 



1,3 IFomicttioimimaiMtfces dm gesttnonnmaire d© mmeinmoilire FLASH 

Le gestionnaire de memoire FLASH est appeie par le gestionnaire de fichier. Les fonctionnalites de base qu'il doit 
fournir sont : 

o La creation au demarrage de PIRD d'un arbre contenant les repertoires et les fichiers presents dans la memoire 
FLASH. Cette creation se fait en appelant la fonction FSCreateEntry du gestionnaire de fichier. 

o La creation ou Pouverture en ecriture d'un fichier de la memoire FLASH, Pecriture dans ce fichier et sa fermeture. 
Ces dernieres fonctionnalites peuvent modifier la position de certains fichiers ou repertoires dans la memoire 
FLASH. Elles doivent done modifier les informations du gestionnaire de fichier avec la fonction FSChangeEntry. 



lo4 Iimtterfaice dm gestjommnaiiire de memmoire FLASH 



Le gestionnaire de memoire FLASH doit travailler en collaboration avec le gestionnaire de fichiers. En particulier II doit 
etre capable de generer un arbre representant les fichiers de la memoire FLASH utilisable par le gestionnaire de fichiers. 
Une solution est de fournir au gestionnaire de memoire FLASH les structures des noeuds et des branches de Parbre pour 
qu'il puisse le creer. Une autre solution est que le gestionnaire de fichier fournisse des fonctions pour ajouter un 
repertoire ou un fichier dans Parbre. Cette deuxieme solution semble preferable car elle limite Pinterdependance entre 
les deux gestionnaires et evite la duplication de code. 

1 .4. 1 Les types de donnees 



1.4.1.1 FlashOpenedFile 



NOM 

FlashOpenedFile - Structure opaque decrivant un fichier de la memoire FLASH en cours d'ecriture 
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struct _FlashOpenedFile FlashOpenedFile ;' 



DESCRIPTION 

Pour pouvoir cr^er ou ecrire une entree (fichier ou repertoire) dans la mdmoire FLASH, le gestionnaire de 
fichier doit appeler Tune des fonctions FlashCreateEntry ou FlashOpenEntry. Ces deux fonctions retournent 
un pointeur vers une structure opaque utilised par le gestionnaire de m£moire FLASH lors des ecritures qui 
suivront. 

1 .4.2 Les fonctions 

Les fonctions decrites ci-dessous sont susceptibles de deplacer des fichiers dans la m^moire FLASH. Elles peuvent done 
appeler a tout moment la fonction du gestionnaire de fichier permettant de mettre a jour les informations sur les fichiers 
en me*moire FLASH : FSChangeEntry. 



1.4.2.1 FlashCreateTree 



NOM 

FlashCreateTree - Cr£e 1'arbre de fichiers de la m^moire FLASH 



SYNOPSIS 

Int FlashCreateTree (FSDirEntry *theRootEntry ) ; 



DESCRIPTION 

Le parametre est un pointeur vers le repertoire racine de la m^moire FLASH vue par le gestionnaire de fichier. 

Parcourt la m^moire FLASH et cree un arbre contenant Parborescence des fichiers presents dans la memoire 
FLASH. L'arbre est cree en appelant la fonction FSAddEntry du gestionnaire de fichiers en lui passant le 
pointeur vers un repertoire deja ere" 6 par le gestionnaire de fichier et les donnees de la nouvelle entree. 



CODE BE RETOUR 

Le code de retour est ERR_NONE si tout s'est bien passe. 



1.4.2.2 FlashCreateEntry 



NOM 

FlashCreateEntry — Cree une entree (fichier ou repertoire) dans la memoire FLASH 

SYNOPSIS 

FlashOpenedFile * 

FlashCreateEntry ( char *theFatherName, 

char *theEntryName, 

UIntl6 theOwner, 

Uintl6 theGroup, 

Uint8 theAccessMode, 

Uint8 theAttributes) ; 



DESCRIPTION 

Cree une entree dans la memoire FLASH. L' entree doit ne pas exister (aucun test n'est effectue). 

Le nom du repertoire pere doit etre un pointeur vers le champ du premier bloc d'un repertoire contenant le nom 
du repertoire. Partant de ce pointeur, il est possible de retrouver l'identificateur du pere qui se trouve un certain 
nombre d' octets avant. 



© Copyright CANAL + 1996 - 1997 page 7/9 

Ce document ne peut etre communique a des tiers sans autorisation ecrite prealable des ayants droits. 



CANAL+ 



27 Janvier 1998 

TV NUMERIQUE ET 



CODE DE RETOUR 

Le code de retour est NULL en cas d'erreur ou si V entree est un repertoire. 

1.4.2.3 Flash ChangeEntry 
NOM 

FlashChangeEntry - Modifie une entree (fichier ou repertoire) dans la memoire FLASH 

SYNOPSIS 

Int FlashChangeEntr 



char 


*the01dFatherName, 


char 


*the01dName, 


char 


* theNewFatherName , 


char 


*theNewName, 


UIntl6 


theOwner, 


UintlG 


the Group, 


Uint8 


theAccessMode , 


Uint8 


theAttributes) ; 



DESCRIPTION 

Modifie les informations sur une entree de la memoire FLASH. L'entree doit deja exister. Elle ne doit pas etre 
en cours d'ecriture. 

theOIdFatherName, theOIdName et theNewFatherName sont des pointeurs vers des noms en memoire 
FLASH contenus dans le premier bloc des entries correspondantes. Les identificateurs de ces entrees se 
trouvent quelques octets avant. 

theNewName est un pointeur vers le nouveau nom. Ce n'est pas forcement un pointeur en memoire FLASH. II 
sera recopte en memoire FLASH dans le nouveau premier bloc qui va 6tre cr6e\ 

CODE DE RETOUR 

Le code de retour est ERR_NONE si tout s'est bien passe. 

1.4.2.4 FlashDeleteEntry 
NOM 

FlashDeleteEntry - D6truit une entree dans la memoire FLASH 
SYNOPSIS 

: Int FlashDeleteEntry (char *theEntryName) ; 

DESCRIPTION 

Le nom sert a retrouver Fidentificateur (quelques octets avant le nom). 

CODE BE RETOUR 

Le code de retour est ERR_NONE si tout s'est bien passe\ 

1.4.2.5 FlashOpenFile 
NOM 

FlashOpenFile - Ouvre un fichier en 6criture dans la memoire FLASH 
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SYNOPSIS 

FlashOpenedFile *FlashOpenFile ( char *theFileName ) ; 
DESCRIPTION 

Prepare une structure interne qui sera utilised pour les Ventures dans ce fichier jusqu'a la fermeture. 

Le nom du fichier est un pointeur vers Ie champ contenant le nom dans le premier bloc du fichier. 
L'identificateur du fichier se trouve quelques octets avant. 

CODE BE RETOUR 

Le code de retour est NULL en cas de probleme. 

1.4.2.6 FlashWriteFile 
NOM 

FlashWriteFile - Ecrit dans un fichier ouvert en memoire FLASH 
SYNOPSIS 

Int FlashWriteFile ( FlashOpenedFile *theOpenedFile , 

UInt32 thelndex, 
char *theBuffer, 
UInt32 theLength) ; 

DESCRIPTION 

Ecrit dans un fichier ouvert dans la memoire FLASH dans le bloc dont Pindice est donn6 en parametre, les 
donn^es du buffer dont la taille est donn£e en parametre. Si aucun bloc d'indice supeYieur n'a €t£ 6crit depuis 
que le fichier a €tt& ouvert : 

1) le pr£c6dent bloc New terminal, s'il existe, est marque comme non terminal, 

2) le bloc courant reste marqu6 comme terminal. 

CODE BE RETOUR 

ERR_NONE si tout se passe bien. 

1.4.2. 7 FlashCloseFile 
NOM 

FlashCloseFile - Ferme un fichier en Venture dans la memoire FLASH 
SYNOPSIS 

Int FlashCloseFile (FlashOpenedFile *theOpenedFile, Bool truncate); 
DESCRIPTION 

Ferme un fichier ouvert en £criture. Si le parametre truncate est true, le bloc de plus grand index parmi ceux 
qui viennent d'etre £crit reste le bloc terminal. Si ce parametre est false, Tancien bloc terminal reste terminal. 

CODE DE RETOUR 

ERR_NONE si tout se passe bien. 

ERR_NO__TERMINAL si truncate est true et aucun bloc n'a 6t6 £crit ou si truncate est false et le fichier est 
nouveau. 
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